home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / pc_board / ez_diz10.zip / EZ-DIZ.DOC < prev    next >
Text File  |  1992-01-07  |  7KB  |  183 lines
  1.                                         
  2.                                   EZ-DIZ v1.0
  3.                          Copyright (c) 1992 By Rick Kuban
  4.  
  5.  
  6.           INTRODUCTION:
  7.           -------------
  8.                EZ-DIZ is a utility program written to automate and
  9.           speed up a PCBoard 14.5+ sysop's maintainance of the upload
  10.           directory files list using the FILE_ID.DIZ and DESC.SDI files
  11.           in the archives. It provides the same functions as the PCBDESC
  12.           utility, but functions from the command line, unlike PCBDESC.
  13.           It may be manually used one file at a time, or, by clever use
  14.           of a batch file, can be used to automatically process an entire
  15.           directory at one time. It contains the intelligence required to
  16.           not process a file that has already been placed in the dir
  17.           listing. It is suitable to run in an event, if desired.
  18.  
  19.  
  20.           STANDARD "DEMO" LICENSE:
  21.           ------------------------
  22.               EZ-DIZ is a Shareware program, and uploading of the code
  23.           to various bulletin boards and Shareware libraries is encouraged.
  24.           Several limitations must be implied, however:
  25.  
  26.           1)  Under no circumstances should the code be modified or dis-
  27.           tributed in any other form than what it was originally supplied
  28.           by the author. The exception is that EZ-DIZ may be compressed
  29.           using techniques other than ZIP, but the de-compressed form of
  30.           EZ-DIZ must remain intact. No files may be added to or removed
  31.           from the archive contents.
  32.  
  33.           Files included in the original archive are:
  34.  
  35.                    EZ-DIZ.exe - the executable program file
  36.                    EZ-DIZ.doc - this documentation file
  37.                    EZDIZ.BAT - sample batch file (single)
  38.                    B-DIZ.bat - sample batch file (batch)
  39.                    EZ-DIZ.reg - registration form
  40.                    FILE_ID.DIZ  - description file
  41.  
  42.           2)  EZ-DIZ may not be redistributed in any manner other than
  43.           electronic file transfer unless cleared with the author beforehand.
  44.           No money may be received for EZ-DIZ except to cover for telecom-
  45.           munications/service charges, and in such a case the cost may not
  46.           exceed $5.00 in US funds.
  47.  
  48.           3)  EZ-DIZ may be run for a period of time adequate to allow
  49.           for full testing of the software. If, after running the code for
  50.           one month, you decide not to purchase the registration license,
  51.           you must forfeit this license and remove EZ-DIZ from operation
  52.           on your system(s). You may keep a copy online for distribution
  53.           purposes only.
  54.  
  55.            4)  EZ-DIZ may not be hacked or modified in ANY manner.
  56.  
  57.  
  58.           REGISTRATION LICENSE:
  59.           ---------------------
  60.           1)   Once purchasing the registration license, the license is
  61.           extended for life. All future releases of EZ-DIZ will be made
  62.           available, for no additional charge.
  63.  
  64.           2)   The registration license is non-refundable and non-transfer-
  65.           able without prior consent of the author. The registration license
  66.           permits the licensee to operate EZ-DIZ on one (1) system only.
  67.           The definition of "system" will be construed to include a multiple
  68.           node network at the same physical location, operating under the
  69.           same bbs name.
  70.  
  71.           3)   The registration fee for EZ-DIZ is $5.00 in US funds.
  72.  
  73.           4)   Product support for EZ-DIZ will be provided to registered
  74.           users thru Technoid's Toybox BBS, (214) 226-6017. The registration
  75.           number mailed to each user will be requested at that time.
  76.  
  77.           DISCLAIMER:
  78.           -----------
  79.                Although the program has been tested, and is currently in
  80.           use on the authors bbs, the author assumes no responsibility nor
  81.           liability for any data loss, incurred costs, equipment or other
  82.           damage as a result of the use of EZ-DIZ. The user assumes all
  83.           risk for damages incurred from the use of this product.
  84.  
  85.  
  86.           OPERATING EZ-DIZ:
  87.           -----------------
  88.           EZ-DIZ is very simple to operate. No setup or configurations
  89.           are required. It is suggested that a batch file be used to
  90.           call EZ-DIZ in order to eliminate keystrokes. Study the
  91.           enclosed examples for reference.
  92.  
  93.           EZ-DIZ should be placed in a directory in the path, and must
  94.           have available to it the appropriate version of PKUNZIP in
  95.           order to be able to retrieve the FILE_ID.DIZ or DESC.SDI file
  96.           from the archive. EZ-DIZ should be called from the uploaded
  97.           files directory (ie... the directory with files to process).
  98.  
  99.           EZ-DIZ relies on two command line arguments passed to it upon
  100.           invocation. The first argument is the fully qualified path and
  101.           filename of the PCBoard directory file to be updated (Example:
  102.           C:\PCB\GEN\UPDIR). The second argument is the name of the ZIP
  103.           file to be processed (Example: EZ-DIZ.ZIP). An example of such
  104.           a command line might be:
  105.  
  106.           C:\UPLOADS> EZ-DIZ C:\pcb\gen\updir ez-diz.zip
  107.  
  108.           Use of a batch file with replaceable parameters would look
  109.           like this:
  110.  
  111.           EZDIZ.BAT
  112.           REM - Process one zip file
  113.           echo of
  114.           ez-diz c:\pcb\gen\updir %1
  115.  
  116.           The above would be called as:
  117.  
  118.           C:\UPLOADS> DIZ ez-diz.zip
  119.  
  120.  
  121.           B-DIZ BATCH FILE:
  122.           ------------------
  123.           When calling up EZ-DIZ, you may want to automatically process
  124.           the entire directory without intervention. Consider the following
  125.           batch file example:
  126.  
  127.           B-DIZ.BAT
  128.           echo off
  129.           for %%x in (*.zip) do ez-diz c:\pcb\gen\updir %%x
  130.  
  131.           The above command line will process every .ZIP file in the
  132.           current directory, placing any FILE_ID.DIZ or DESC.SDI descriptions
  133.           found in the directory file UPDIR in the C:\PCB\GEN subdirectory.
  134.  
  135.           Do NOT include a drive\path for the filename; to do so will
  136.           result in a failure to operate properly... change to the
  137.           directory to be processed first.
  138.  
  139.  
  140.           OPERATIONAL NOTE:
  141.           -----------------
  142.           EZ-DIZ places a temporary placeholder in the dir file for the
  143.           zipfile's size and date. If you view the dir file with a text
  144.           editor immediately after running EZ-DIZ, you will see a 1 byte
  145.           file size and 01-01-80 for the date. Do not be alarmed...the
  146.           placeholder will be replaced with the proper information when
  147.           PCBFiler resaves the file the first time.
  148.  
  149.           ACKNOWLEDGEMENTS:
  150.           -----------------
  151.           PKUNZIP; PKWare, Inc.
  152.           PCBoard, PCBDesc, PCBFiler; Clark Development Co., Inc
  153.  
  154. ------------------------------------------------------------------------------
  155.  
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.